home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / roboinst_config.z / roboinst_config
Encoding:
Text File  |  2001-04-17  |  35.8 KB  |  595 lines

  1.  
  2.  
  3.  
  4. rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))                                        rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      roboinst_config, mrconfig - configure automatic installation server
  10.      directory
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg [ ----nnnnxxxxyyyy ] [ ----cccc configdir ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _r_o_b_o_i_n_s_t__c_o_n_f_i_g is run on the configuration server system to check and
  17.      index the contents of an _r_o_b_o_i_n_s_t configuration directory (ccccoooonnnnffffiiiiggggddddiiiirrrr).
  18.      The _m_r_c_o_n_f_i_g file is parsed for errors, other scripts, if any, are
  19.      checked, and a table of contents is built.  Any custom configuration
  20.      directories (for specific hardware or network addresses) beneath the
  21.      configuration directory are also checked and included in the table of
  22.      contents.
  23.  
  24.      _r_o_b_o_i_n_s_t__c_o_n_f_i_g first reads the _m_r_c_o_n_f_i_g file.  The _m_r_c_o_n_f_i_g file must be
  25.      present in the configuration directory.
  26.  
  27.      The _m_r_c_o_n_f_i_g file controls the RoboInst automatic installation session.
  28.      Each line in the _m_r_c_o_n_f_i_g file is a statement which specifies actions to
  29.      occur at each phase of the automatic installation.  Each statement is
  30.      comprised of a _k_e_y_w_o_r_d and its arguments.
  31.  
  32.      The ordering of lines is only significant among lines that have the same
  33.      _k_e_y_w_o_r_d.  For example, all lines that begin with the iiiinnnnsssstttt _k_e_y_w_o_r_d are
  34.      assumed to contain input lines for _i_n_s_t(1M), and this input is passed to
  35.      _i_n_s_t in the same order it appears in the _m_r_c_o_n_f_i_g file.
  36.  
  37.      Blank lines and lines beginning with #### are ignored.
  38.  
  39.      This is the order in which events happen in an automatic installation
  40.      process in the miniroot:
  41.  
  42.           1111....   system restarted to the miniroot
  43.           2222....   configuration directory downloaded and _m_r_c_o_n_f_i_g file
  44.                preprocessed
  45.           3333....   iiiinnnniiiitttt keyword commands executed
  46.           4444....   disks partitioned as per ppppaaaarrrrttttiiiittttiiiioooonnnn keywords
  47.           5555....   ffffxxxx keyword commands executed
  48.           6666....   filesystems created as per ppppaaaarrrrttttiiiittttiiiioooonnnn keywords
  49.           7777....   mmmmkkkkffffssss keyword commands executed
  50.           8888....   filesystems mounted
  51.           9999....   pppprrrreeeeiiiinnnnsssstttt keyword commands executed
  52.           11110000....  iiiinnnnsssstttt keyword commands executed
  53.           11111111....  build new kernel, unless the nnnnooookkkkeeeerrrrnnnneeeellll keyword is specified
  54.           11112222....  ppppoooossssttttiiiinnnnsssstttt keyword commands executed
  55.           11113333....  restart system to multi-user mode
  56.  
  57.      In a live automatic installation the order of events is as follows:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))                                        rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))
  71.  
  72.  
  73.  
  74.           1111....   configuration directory downloaded and _m_r_c_o_n_f_i_g file
  75.                preprocessed
  76.           2222....   iiiinnnniiiitttt keyword commands executed
  77.           3333....   pppprrrreeeeiiiinnnnsssstttt keyword commands executed
  78.           4444....   iiiinnnnsssstttt keyword commands executed
  79.           5555....   ppppoooossssttttiiiinnnnsssstttt keyword commands executed
  80.  
  81.      The syntax of the _m_r_c_o_n_f_i_g keywords is detailed below:
  82.  
  83.      vvvveeeerrrrssssiiiioooonnnn _n_u_m_b_e_r
  84.                 Versioning information in case new keywords are added in the
  85.                 future.  If this keyword is omitted, version 1 is assumed.
  86.                 The RoboInst software will terminate with an error if it
  87.                 encounters a _m_r_c_o_n_f_i_g file with a higher version number.
  88.  
  89.      lllloooogggghhhhoooosssstttt _I_P _a_d_d_r_e_s_s(_e_s)
  90.                 The IP address(es) of the host(s) to which syslog messages
  91.                 will be forwarded, in addition to being logged on the client.
  92.  
  93.      sssseeeetttteeeennnnvvvv _v_a_r_i_a_b_l_e _v_a_l_u_e
  94.                 Set the named RoboInst environment variable.  The variable is
  95.                 also exported to subcommands, such as those executed in the
  96.                 pppprrrreeeeiiiinnnnsssstttt, ppppoooossssttttiiiinnnnsssstttt, etc., phases of the installation.
  97.  
  98.      oooonnnneeeerrrrrrrroooorrrr _a_c_t_i_o_n
  99.                 The oooonnnneeeerrrrrrrroooorrrr keyword controls the behavior of _i_n_s_t in response
  100.                 to an error, such as incompatible product selections, disk
  101.                 space shortages, etc.  If set to iiiiggggnnnnoooorrrreeee, the default, then
  102.                 _i_n_s_t continues without stopping if an error is detected
  103.                 (errors are still reported in /_r_o_o_t/_v_a_r/_i_n_s_t/_I_N_S_T_L_O_G and in
  104.                 the SYSLOG).  If set to wwwwaaaaiiiitttt, _i_n_s_t will stop and wait for a
  105.                 response from the user (interactive mode) whenever an error
  106.                 occurs.
  107.  
  108.      ppppaaaarrrrttttiiiittttiiiioooonnnn _d_e_v_i_c_e _s_i_z_e _t_y_p_e _n_a_m_e _o_p_t_i_o_n_s
  109.                 Specify partitions to create and filesystems to mount (see
  110.                 PPPPaaaarrrrttttiiiittttiiiioooonnnniiiinnnngggg section below).
  111.  
  112.      ddddiiiisssskkkksssseeeettttuuuupppp  This keyword is required when repartitioning of the root disk
  113.                 drive is requested, and the drive is either uninitialized (has
  114.                 no volume header) or in a pre-6.5 format, that is, when swap
  115.                 is not located just after the volume header at the physical
  116.                 beginning of the drive.  Specifying this keyword will cause
  117.                 the swap partition to be relocated to the beginning of the
  118.                 drive, when the installation session is initiated from multi-
  119.                 user mode using _r_o_b_o_i_n_s_t(1M).  NNNNooootttteeee:::: if the installation is
  120.                 initiated from the PROM command monitor, the ddddiiiisssskkkksssseeeettttuuuupppp keyword
  121.                 will be ignored.  You must also specify ddddiiiisssskkkksssseeeettttuuuupppp====ttttrrrruuuueeee on the
  122.                 bbbbooooooootttt command line when initiating roboinst from the PROM
  123.                 command monitor (see _p_r_o_m(1M)).  See PPPPaaaarrrrttttiiiittttiiiioooonnnniiiinnnngggg section
  124.                 below.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))                                        rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      iiiinnnniiiitttt /_b_i_n/_s_h _c_o_m_m_a_n_d
  141.                 This keyword is used to specify shell commands to be executed
  142.                 during the iiiinnnniiiitttt phase.
  143.  
  144.      ffffxxxx /_b_i_n/_s_h _c_o_m_m_a_n_d
  145.                 This keyword is used to specify shell commands to be executed
  146.                 during the ffffxxxx phase.
  147.  
  148.      mmmmkkkkffffssss /_b_i_n/_s_h _c_o_m_m_a_n_d
  149.                 This keyword is used to specify shell commands to be executed
  150.                 during the mmmmkkkkffffssss phase.
  151.  
  152.      pppprrrreeeeiiiinnnnsssstttt /_b_i_n/_s_h _c_o_m_m_a_n_d
  153.                 This keyword is used to specify shell commands to be executed
  154.                 during the pppprrrreeeeiiiinnnnsssstttt phase.
  155.  
  156.      iiiinnnnsssstttt _i_n_s_t _c_o_m_m_a_n_d
  157.                 _I_n_s_t command to be executed.  Multiple iiiinnnnsssstttt keywords may be
  158.                 specified.  Commands are collected in the order they appear in
  159.                 the _m_r_c_o_n_f_i_g file, copied into a temporary command file, and
  160.                 _i_n_s_t is invoked with the ----cccc argument.
  161.  
  162.      nnnnooookkkkeeeerrrrnnnneeeellll   The presence of this keyword causes the _a_u_t_o_c_o_n_f_i_g(1M) phase
  163.                 to be skipped, so that a new UNIX kernel will not be
  164.                 automatically generated.  If you use this keyword, you must
  165.                 manually build the UNIX kernel from your own scripts, if
  166.                 necessary.  Normally a new kernel named /_r_o_o_t/_u_n_i_x._i_n_s_t_a_l_l is
  167.                 generated by the _a_u_t_o_c_o_n_f_i_g(1M) command.  If it builds
  168.                 successfully, it is renamed to /_r_o_o_t/_u_n_i_x before the system is
  169.                 restarted to multi-user mode, something like this:
  170.  
  171.                   _iiii_ffff _eeee_cccc_hhhh_oooo _yyyy _|||| _cccc_hhhh_rrrr_oooo_oooo_tttt _////_rrrr_oooo_oooo_tttt _\\\\
  172.                       _////_eeee_tttt_cccc_////_iiii_nnnn_iiii_tttt_...._dddd_////_aaaa_uuuu_tttt_oooo_cccc_oooo_nnnn_ffff_iiii_gggg _----_oooo _----_NNNN
  173.                   _tttt_hhhh_eeee_nnnn
  174.                       _mmmm_vvvv _////_rrrr_oooo_oooo_tttt_////_uuuu_nnnn_iiii_xxxx_...._iiii_nnnn_ssss_tttt_aaaa_llll_llll _////_rrrr_oooo_oooo_tttt_////_uuuu_nnnn_iiii_xxxx
  175.                   _ffff_iiii
  176.  
  177.  
  178.  
  179.      ppppoooossssttttiiiinnnnsssstttt /_b_i_n/_s_h _c_o_m_m_a_n_d
  180.                 This keyword is used to specify shell commands to be executed
  181.                 during the ppppoooossssttttiiiinnnnsssstttt phase.
  182.  
  183.      iiiiffff /_b_i_n/_s_h _c_o_m_m_a_n_d
  184.      ............
  185.      eeeellllssssiiiiffff /_b_i_n/_s_h _c_o_m_m_a_n_d
  186.      ............
  187.      eeeellllsssseeee
  188.      ............
  189.      eeeennnnddddiiiiffff      The conditional syntax is similar to the iiiiffff syntax in _s_h(1).
  190.                 The first command is executed and if it exits with a status of
  191.                 zero, then all lines up to the next eeeellllsssseeee, eeeellllssssiiiiffff or eeeennnnddddiiiiffff
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))                                        rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))
  203.  
  204.  
  205.  
  206.                 statement are evaluated.  Otherwise, the next command is
  207.                 executed and if its exit status is zero, all lines up to the
  208.                 next eeeellllsssseeee, eeeellllssssiiiiffff or eeeennnnddddiiiiffff statement are evaluated, and so on.
  209.                 If all the commands exit non-zero, lines following the final
  210.                 eeeellllsssseeee (if present) are evaluated.
  211.  
  212.                 As in /bin/sh, the eeeellllssssiiiiffff and eeeellllsssseeee clauses are optional.
  213.                 Multiple eeeellllssssiiiiffff clauses are allowed. Nesting of iiiiffff statements
  214.                 is permitted.  Any trailing ;;;; tttthhhheeeennnn is stripped from iiiiffff and
  215.                 eeeellllssssiiiiffff statements before the command is executed.
  216.  
  217.  
  218.                 Conditional statements are useful for performing different
  219.                 disk partitioning, or software installation instructions,
  220.                 depending on CPU or graphics type, for example:
  221.  
  222.  
  223.                     if [ $SGI_CPUBOARD = IP30 ]; then
  224.                        init echo This is an Octane
  225.                     elsif [ $SGI_CPUBOARD = IP22 ]; then
  226.                         init echo This is an Indy
  227.                     else
  228.                         init echo Neither an Octane nor an Indy
  229.                     endif
  230.  
  231.    EEEEnnnnvvvviiiirrrroooonnnnmmmmeeeennnntttt VVVVaaaarrrriiiiaaaabbbblllleeeessss
  232.      RoboInst exports environment variables to commands and subcommands
  233.      executed during the automatic installation.  Some variables can have
  234.      multiple values.  In that case the values are separated by whitespace.
  235.      The pre-defined variables and values are as follows:
  236.  
  237.  
  238.           SSSSGGGGIIII____CCCCPPPPUUUUBBBBOOOOAAAARRRRDDDD    The value of CPUBOARD as per the _i_n_s_t(1M) aaaaddddmmmmiiiinnnn
  239.                           hhhhaaaarrrrddddwwwwaaaarrrreeee command.
  240.  
  241.           SSSSGGGGIIII____CCCCPPPPUUUUAAAARRRRCCCCHHHH
  242.           SSSSGGGGIIII____AAAABBBBIIII         SSSSGGGGIIII____CCCCPPPPUUUUAAAARRRRCCCCHHHH is set to the value of CPUARCH as per
  243.                           the _i_n_s_t(1M) aaaaddddmmmmiiiinnnn hhhhaaaarrrrddddwwwwaaaarrrreeee command, specifically,
  244.                           the processor type.  The value of the CPUARCH _A_B_I(5)
  245.                           type is available in the SSSSGGGGIIII____AAAABBBBIIII variable.  For
  246.                           example, if _i_n_s_t reports both CPUARCH=R4000 and
  247.                           CPUARCH=MIPS2, then the variable SSSSGGGGIIII____CCCCPPPPUUUUAAAARRRRCCCCHHHH is set
  248.                           to R4000, and SSSSGGGGIIII____AAAABBBBIIII is set to MIPS2.
  249.  
  250.           SSSSGGGGIIII____GGGGFFFFXXXXBBBBOOOOAAAARRRRDDDD    The value of GFXBOARD as per the _i_n_s_t(1M) aaaaddddmmmmiiiinnnn
  251.                           hhhhaaaarrrrddddwwwwaaaarrrreeee command.
  252.  
  253.           SSSSGGGGIIII____SSSSUUUUBBBBGGGGRRRR       The value of SUBGR as per the _i_n_s_t(1M) aaaaddddmmmmiiiinnnn
  254.                           hhhhaaaarrrrddddwwwwaaaarrrreeee command.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))                                        rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))
  269.  
  270.  
  271.  
  272.           SSSSGGGGIIII____MMMMOOOODDDDEEEE        The value of MODE as per the _i_n_s_t(1M) aaaaddddmmmmiiiinnnn hhhhaaaarrrrddddwwwwaaaarrrreeee
  273.                           command.
  274.  
  275.           SSSSGGGGIIII____MMMMAAAACCCCHHHHIIIINNNNEEEE     The value of MACHINE as per the _i_n_s_t(1M) aaaaddddmmmmiiiinnnn
  276.                           hhhhaaaarrrrddddwwwwaaaarrrreeee command.
  277.  
  278.           SSSSGGGGIIII____IIIIPPPPAAAADDDDDDDDRRRR      The network IP address of the system, as stored in
  279.                           the _n_v_r_a_m(1M) nnnneeeettttaaaaddddddddrrrr variable.
  280.  
  281.           SSSSGGGGIIII____CCCCAAAAPPPPAAAACCCCIIIITTTTYYYY
  282.           SSSSGGGGIIII____CCCCAAAAPPPP____ddddkkkkssss####dddd####vvvvoooollll
  283.                           SSSSGGGGIIII____CCCCAAAAPPPPAAAACCCCIIIITTTTYYYY is set to the capacity of the root disk
  284.                           drive, in 512-byte blocks.  The variables
  285.                           SSSSGGGGIIII____CCCCAAAAPPPP____ddddkkkkssss####dddd####vvvvoooollll are also set to correspond to the
  286.                           capacity of specific SCSI disk drives attached to
  287.                           the system.  For example, if you have a 2 GB system
  288.                           disk (_d_k_s_0_d_1_v_o_l) and a 1 GB option disk (_d_k_s_0_d_2_v_o_l)
  289.                           then the following variables would be set:
  290.                               _SSSS_GGGG_IIII______CCCC_AAAA_PPPP_AAAA_CCCC_IIII_TTTT_YYYY_====_4444_1111_9999_7777_4444_0000_5555
  291.                               _SSSS_GGGG_IIII______CCCC_AAAA_PPPP______dddd_kkkk_ssss_0000_dddd_1111_vvvv_oooo_llll_====_4444_1111_9999_7777_4444_0000_5555
  292.                               _SSSS_GGGG_IIII______CCCC_AAAA_PPPP______dddd_kkkk_ssss_0000_dddd_2222_vvvv_oooo_llll_====_2222_0000_7777_0000_2222_3333_5555
  293.  
  294.           SSSSGGGGIIII____RRRROOOOOOOOTTTT        Set to the pathname of the directory where the
  295.                           actual system root directory (when the system is
  296.                           booted normally) is mounted.  If the installation is
  297.                           being performed in the miniroot SSSSGGGGIIII____RRRROOOOOOOOTTTT is set to
  298.                           /_r_o_o_t; in a live installation (_r_o_b_o_i_n_s_t -_L),
  299.                           SSSSGGGGIIII____RRRROOOOOOOOTTTT is normally set to /.
  300.  
  301.           SSSSGGGGIIII____SSSSYYYYSSSSTTTTEEEEMMMMPPPPAAAARRRRTTTT  The device name of the swap partition that the
  302.                           miniroot is loaded onto.  For example, ddddkkkkssss0000dddd1111ssss0000.  In
  303.                           live mode (-L) this is the partition where the
  304.                           directory / is mounted.
  305.  
  306.           SSSSGGGGIIII____SSSSYYYYSSSSTTTTEEEEMMMMDDDDIIIISSSSKKKK  This is the same as SGI_SYSTEMPART, without the
  307.                           final partition number.  For example, ddddkkkkssss0000dddd1111.
  308.  
  309.           SSSSGGGGIIII____CCCCUUUUSSSSTTTTOOOOMMMM      Set to the pathname of the directory to which your
  310.                           _m_r_c_o_n_f_i_g file, and any other custom files, are
  311.                           copied during the automatic installation process.
  312.                           In a miniroot installation, this is usually /_c_u_s_t_o_m;
  313.                           in a live installation, SSSSGGGGIIII____CCCCUUUUSSSSTTTTOOOOMMMM is set to the
  314.                           name of a temporary directory, such as
  315.                           /_t_m_p/_d._r_o_b_o_i_n_s_t._N_N_N_N_N (where _N_N_N_N_N is a unique
  316.                           number).
  317.  
  318.           SSSSGGGGIIII____HHHHOOOOSSSSTTTTNNNNAAAAMMMMEEEE    Set to the _h_o_s_t_n_a_m_e(1) of the client machine, or a
  319.                           NULL string if the hostname has not been set.
  320.  
  321.           SSSSGGGGIIII____SSSSYYYYSSSSIIIIDDDD       Set to the system identifier comprised of 12
  322.                           hexadecimal characters, for example,
  323.                           08:00:69:07:73:80.
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))                                        rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))
  335.  
  336.  
  337.  
  338.           SSSSGGGGIIII____MMMMEEEEMMMMSSSSIIIIZZZZEEEE     Set to the amount of memory on the system in
  339.                           megabytes (MB), as reported by _h_i_n_v(1).
  340.  
  341.           SSSSGGGGIIII____BBBBOOOOOOOOTTTTSSSSEEEERRRRVVVVEEEERRRR
  342.           SSSSGGGGIIII____BBBBOOOOOOOOTTTTDDDDIIIIRRRR     SSSSGGGGIIII____BBBBOOOOOOOOTTTTSSSSEEEERRRRVVVVEEEERRRR is set to the name of the machine
  343.                           from which the miniroot was booted.  SSSSGGGGIIII____BBBBOOOOOOOOTTTTDDDDIIIIRRRR is
  344.                           set to the name of the directory containing that
  345.                           miniroot.
  346.  
  347.           SSSSGGGGIIII____CCCCOOOONNNNFFFFIIIIGGGGSSSSEEEERRRRVVVVEEEERRRR
  348.           SSSSGGGGIIII____CCCCOOOONNNNFFFFIIIIGGGGDDDDIIIIRRRR   SSSSGGGGIIII____CCCCOOOONNNNFFFFIIIIGGGGSSSSEEEERRRRVVVVEEEERRRR is set to the name of the machine
  349.                           from which your custom files (_m_r_c_o_n_f_i_g, ._i_n_d_e_x,
  350.                           etc.) were copied.  SSSSGGGGIIII____CCCCOOOONNNNFFFFIIIIGGGGDDDDIIIIRRRR is set to the name
  351.                           of the directory containing those files.
  352.  
  353.    PPPPaaaarrrrttttiiiittttiiiioooonnnniiiinnnngggg
  354.      Use the ppppaaaarrrrttttiiiittttiiiioooonnnn keyword to specify disk partitioning, filesystems and
  355.      mount points.  The syntax for this keyword is:
  356.  
  357.          ppppaaaarrrrttttiiiittttiiiioooonnnn _d_e_v_i_c_e _s_i_z_e _t_y_p_e _n_a_m_e _m_o_u_n_t-_o_p_t_i_o_n_s ; _m_k_f_s-_o_p_t_i_o_n_s ;
  358.  
  359.      The _d_e_v_i_c_e, _s_i_z_e, and _t_y_p_e arguments are used as input to the _f_x -_s
  360.      command to perform disk partitioning.  Partitions are laid out in the
  361.      order specified, unless a start position is given.  The _n_a_m_e and _m_o_u_n_t-
  362.      _o_p_t_i_o_n_s (if any) are used as input to the _m_o_u_n_t(1M) command.  The _m_k_f_s-
  363.      _o_p_t_i_o_n_s (if any) are used as input to the _m_k_f_s__x_f_s(1M) command.
  364.  
  365.      For example to create a standard system disk layout one might use:
  366.  
  367.          partition dks0d1s0 standard root /
  368.  
  369.      or
  370.  
  371.          partition systemdisk standard root /
  372.  
  373.      And to create a standard option disk mounted at /d2:
  374.  
  375.          partition dks0d2s0 standard option /d2
  376.  
  377.      NNNNooootttteeee:::: in order for repartitioning of the system disk to work properly,
  378.      the ddddiiiisssskkkksssseeeettttuuuupppp keyword (described above) must appear in the _m_r_c_o_n_f_i_g file,
  379.      or the ddddiiiisssskkkksssseeeettttuuuupppp====ttttrrrruuuueeee argument should be specified on the bbbbooooooootttt command
  380.      line when initiating _r_o_b_o_i_n_s_t(_1_M) from the PROM command monitor.
  381.  
  382.      The partition arguments are as follows.
  383.  
  384.      _d_e_v_i_c_e is one of:
  385.  
  386.  
  387.           ssssyyyysssstttteeeemmmmddddiiiisssskkkk      a shorthand notation for partition 0 of the disk on
  388.                           which the miniroot is currently loaded (the current
  389.                           system disk). If this keyword is immediately
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))                                        rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))
  401.  
  402.  
  403.  
  404.                           followed by a number (eg. ssssyyyysssstttteeeemmmmddddiiiisssskkkk1111) it refers to
  405.                           a specific partition on the system disk.
  406.  
  407.           _d_e_v_i_c_e _n_a_m_e     The name of a disk device in the /_d_e_v/_r_d_s_k
  408.                           directory, for example ddddkkkkssss0000dddd1111ssss0000.  See _d_k_s(7M) for a
  409.                           full description of device names.
  410.  
  411.      _s_i_z_e is one of:
  412.  
  413.           eeeexxxxiiiissssttttiiiinnnngggg        Keep the same size.
  414.  
  415.           ssssttttaaaannnnddddaaaarrrrdddd        Use a standard layout for the entire disk. Type rrrrooooooootttt
  416.                           or ooooppppttttiiiioooonnnn must also be specified (see below).  When
  417.                           ssssttttaaaannnnddddaaaarrrrdddd is used, it applies to the entire disk (the
  418.                           _p_a_r_t_i_t_i_o_n component in the device name is
  419.                           irrelevant).  For most partitioning tasks, either
  420.                           ssssttttaaaannnnddddaaaarrrrdddd rrrrooooooootttt or ssssttttaaaannnnddddaaaarrrrdddd ooooppppttttiiiioooonnnn should be specified
  421.                           as the first ppppaaaarrrrttttiiiittttiiiioooonnnn statement for the given disk.
  422.                           If customizations are desired, additional ppppaaaarrrrttttiiiittttiiiioooonnnn
  423.                           statements for that disk may also be specified.
  424.  
  425.           aaaallllllll             The entire disk.
  426.  
  427.           _s_t_a_r_t:_s_i_z_e _s_t_a_r_t is an integer that specifies the exact start
  428.                           address of the partition, in 512-byte blocks.
  429.                           Alternatively, _s_t_a_r_t can be ffffoooolllllllloooowwwwssssppppaaaarrrrtttt#### where #### is
  430.                           the partition number which this partition is to
  431.                           immediately follow on the same disk.  NNNNooootttteeee:::: the
  432.                           volume header is partition 8, so normally the first
  433.                           usable partition would use ffffoooolllllllloooowwwwssssppppaaaarrrrtttt8888.  _s_i_z_e is an
  434.                           integer that specifies the size of the partition in
  435.                           512-byte blocks, or the word rrrreeeemmmmaaaaiiiinnnnddddeeeerrrr to use the
  436.                           entire remainder of disk after making all other
  437.                           partitions.  NNNNooootttteeee:::: partitions are processed in the
  438.                           order they appear in the file, so rrrreeeemmmmaaaaiiiinnnnddddeeeerrrr should
  439.                           be used only in the last ppppaaaarrrrttttiiiittttiiiioooonnnn statement for a
  440.                           particular disk.
  441.  
  442.      _t_y_p_e is one of:
  443.  
  444.           rrrrooooooootttt            Only valid when ssssttttaaaannnnddddaaaarrrrdddd is specified (see above).
  445.                           A standard root disk is created, consisting of a
  446.                           swap partition and a root partition of maximum size
  447.                           containing an XFS filesystem.
  448.  
  449.           ooooppppttttiiiioooonnnn          Only valid when ssssttttaaaannnnddddaaaarrrrdddd is specified (see above).
  450.                           A standard option disk is created, consisting of a
  451.                           single partition of maximum size, containing an XFS
  452.                           filesystem.
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))                                        rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))
  467.  
  468.  
  469.  
  470.           xxxxffffssss
  471.           xxxxffffssss ////bbbblllloooocccckkkkssssiiiizzzzeeee  An XFS filesystem is created with the specified
  472.                           _b_l_o_c_k_s_i_z_e, and mounted at the directory _n_a_m_e with
  473.                           the specified _o_p_t_i_o_n_s.  The blocksize must be an
  474.                           integer multiple of 512 and cannot exceed 65536.  If
  475.                           omitted, a blocksize of 4096 is assumed.
  476.  
  477.           eeeeffffssss             An EFS filesystem is created, and mounted at the
  478.                           directory _n_a_m_e with the specified _o_p_t_i_o_n_s.  CCCCaaaauuuuttttiiiioooonnnn::::
  479.                           EFS filesystems will not be supported in future IRIX
  480.                           releases.  Use XFS filesystems in nearly all
  481.                           situations.
  482.  
  483.           sssswwwwaaaapppp            A swap partition of the specified _s_i_z_e is created.
  484.  
  485.           pppprrrreeeesssseeeerrrrvvvveeee        Any existing filesystem is preserved, and no new one
  486.                           is created.
  487.  
  488.      _n_a_m_e is ignored when type is sssswwwwaaaapppp.  For other partition types, its value
  489.      can be:
  490.  
  491.           _p_a_t_h_n_a_m_e        A local directory where the filesystem is to be
  492.                           mounted.
  493.  
  494.           nnnnoooommmmoooouuuunnnntttt         If nnnnoooommmmoooouuuunnnntttt is specified, the filesystem is not
  495.                           mounted.
  496.  
  497.      _o_p_t_i_o_n_s are:
  498.  
  499.           ooooppppttttiiiioooonnnnssss         See _m_o_u_n_t(1M) for legal options.  This field is
  500.                           optional.  Any ooooppppttttiiiioooonnnnssss specified are to be passed
  501.                           along to the _mmmm_oooo_uuuu_nnnn_tttt _----_oooo command as a single argument.
  502.                           Multiple options should be comma separated with no
  503.                           spaces.
  504.  
  505.    EEEExxxxaaaammmmpppplllleeee
  506.      Consider the job of partitioning a set of Indy, O2/R5K and O2/R10K
  507.      clients.  The O2/R10K machines normally have the root drive at _d_k_s_0_d_2_s_0,
  508.      but on the other we would like to use _d_k_s_0_d_1_s_0 for the root drive.  This
  509.      can be handled with a single _m_r_c_o_n_f_i_g file using the ssssyyyysssstttteeeemmmmddddiiiisssskkkk keyword
  510.      as follows:
  511.  
  512.               # The following "disksetup" keyword applies to all machines
  513.               disksetup
  514.               partition systemdisk standard root /
  515.  
  516.  
  517.      The same task could also be accomplished using explicit disk device names
  518.      with:
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))                                        rrrroooobbbbooooiiiinnnnsssstttt____ccccoooonnnnffffiiiigggg((((1111MMMM))))
  533.  
  534.  
  535.  
  536.               # The following "disksetup" keyword applies to all machines
  537.               disksetup
  538.  
  539.               if [ "$SGI_CPUBOARD" = IP32 -a "$SGI_CPUARCH" = R10000 ] then
  540.  
  541.                   # On O2/R10K machines use drive 2
  542.                   init               echo This is an O2/R10K
  543.                   partition          dks0d2s0 standard root /
  544.  
  545.               else
  546.  
  547.                   # On my other machines put root on drive 1
  548.                   init               echo The machine type is $SGI_MACHINE
  549.                   partition          dks0d1s0 standard root /
  550.  
  551.               endif
  552.  
  553.      For more examples, install the optional subsystem roboinst.sw.examples
  554.      using _i_n_s_t(1M) or _S_o_f_t_w_a_r_e _M_a_n_a_g_e_r(1M).
  555.  
  556. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  557.      The _r_o_b_o_i_n_s_t__c_o_n_f_i_g command accepts the following options:
  558.  
  559.      ----cccc _c_o_n_f_i_g_d_i_r
  560.                 Specify an alternate _r_o_b_o_i_n_s_t configuration directory.  If no
  561.                 alternate configuration directory is specified, it is assumed
  562.                 to be the current directory.
  563.  
  564.      ----nnnn         Do not write the table of contents.
  565.  
  566.      ----yyyy         Always write the table of contents, even if it already exists.
  567.  
  568.      ----xxxx         Do not write file size and checksum information to the table
  569.                 of contents.  This option may be useful while debugging the
  570.                 _m_r_c_o_n_f_i_g file and other scripts in the configuration
  571.                 directory.  However, if the table of contents does not contain
  572.                 file size and checksum information then it will not be
  573.                 possible to detect file transfer errors during the automatic
  574.                 installation process.
  575.  
  576. FFFFIIIILLLLEEEESSSS
  577.      _c_o_n_f_i_g_d_i_r/.index    Table of contents for the specified configuration
  578.                          directory.
  579.      /_u_s_r/_s_h_a_r_e/_s_r_c/_R_o_b_o_I_n_s_t/*
  580.                          RoboInst examples.
  581.  
  582. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  583.      ABI(5), autoconfig(1M), dks(7M), fx(1M), hinv(1), hostname(1), inst(1M),
  584.      mount(1M), nvram(1M), prom(1M), roboinst(1M), sh(1) and the online book
  585.      _I_R_I_X _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g.
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.